home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PRINTER / LASER10.ARJ / LASER1.DOC < prev    next >
Text File  |  1992-08-05  |  10KB  |  240 lines
  1. Program           : LASER1  Version 1.0
  2. -------
  3.  
  4. Release Date      : August 1992.
  5. ------------
  6.  
  7. Purpose           :  This program solves 2 problems:
  8. -------
  9.                      1) You want to print a mailing label. You already have
  10.                         the name and address data on your computer, in an
  11.                         application that can display it in a consistent
  12.                         format, but it does not provide a "print this label"
  13.                         function and you don't want to type it again.
  14.  
  15.                      2) You have a laser printer, which prints a page at a
  16.                         time and you hate to waste a full page of labels
  17.                         to print just one.
  18.  
  19. Solution Approach:
  20. ------------------
  21.  
  22. The solution I chose was to write a memory resident program that READS THE
  23. SCREEN at user specified positions, and prints the data to a mailing label,
  24. where the label's position on a sheet is input at run time.
  25.  
  26. The program is made resident by a batch file that then invokes the
  27. application, and upon exiting the application, uninstalls the program.
  28. Consequently, the program is only in memory (using about 66k of ram) when
  29. you need it!
  30.  
  31. Two nice features:
  32. ------------------
  33.  
  34. 1) You don't just select a block of text from the screen, but rather specify
  35.    individual "fields". That way your label can show the fields in a
  36.    different order than the way they appear on the screen, and you may skip
  37.    over certain fields and not have them printed.
  38.  
  39. 2) You can add extra literals to your label that do not appear on the screen.
  40.  
  41.  
  42. How to install
  43. --------------
  44.  
  45.             Step 1: Create a Screen Definition File. (A one-time effort).
  46.  
  47.             Step 2: Create (or modify) a batch file to invoke the
  48.                     application after first loading LASER1 into memory.
  49.                     (Also a one-time effort).
  50.  
  51.             Step 3: Whenever you are in the application, displaying the
  52.                     name and address on the screen, hit the LASER1 HOT KEY
  53.                     combination (ALT D) to capture the data and print the
  54.                     label. You will be prompted for justification preference
  55.                     and to tell it which label position on the sheet of
  56.                     labels to print upon.
  57.  
  58.             After the label is printed, you can peel it off, but use the
  59.             same sheet of remaining labels next time!
  60.  
  61. Step 1 details:
  62. ---------------
  63. The screen definition file tells LASER1 which portions of the screen
  64. contain the information for your mailing label, and in what order to print.
  65.  
  66. If you have multiple applications that you wish to print labels from,
  67. simply create multiple screen definition files. The batch file that loads
  68. your application is what tells the program which screen definition file to use.
  69.  
  70. You create the screen definition file using any ASCII text editor. Choose any
  71. file name you are comfortable with (I use "laser1.scr").
  72.  
  73. The first line of the file specifies which colors the data will be displayed
  74. in. The format is {foreground color, background color,} separated by a
  75. comma, using the following color codes:
  76.  
  77.   Dark Colors  |
  78.  (Foreground & |  Light Colors
  79.   Background)  |  (Foreground)
  80. ----------------------------------
  81.  Black     | 0 | DarkGray     |  8
  82.  Blue      | 1 | LightBlue    |  9
  83.  Green     | 2 | LightGreen   | 10
  84.  Cyan      | 3 | LightCyan    | 11
  85.  Red       | 4 | LightRed     | 12
  86.  Magenta   | 5 | LightMagenta | 13
  87.  Brown     | 6 | Yellow       | 14
  88.  LightGray | 7 | White        | 15
  89.  
  90. Each successive line in the file specifies a "field" to capture from the
  91. screen. The format is: {Row,Column,Length,Label Print Line,} where each
  92. entity (including the last) is separated by a comma.
  93. The order is significant!  The label fields are printed in the same order
  94. that they appear in the screen definition file.
  95.  
  96. The program strips out leading and trailing blanks, then adds a single blank
  97. space between each field.
  98.  
  99. To make it easier to determine the row and column of fields on your screen,
  100. a memory resident program (TSRRUL) is included. Simly type "TSRRUL" at the
  101. DOS prompt and hit ALT R to activate. It will draw a ruler line on the
  102. screen which can be moved with the up and down arrows. Uninstall by typing
  103. "TSRRUL U" at the DOS prompt.
  104.  
  105. Step 2 details:
  106. ---------------
  107.  
  108. Chances are, you already use a batch file to invoke your application. All
  109. you have to do is add 2 lines to the batch file. Immediately before the
  110. application is executed, insert a line as follows:
  111. "LASER1 screendeffilename", where screendeffilename is the name of the
  112. screen definition file, including the path name. Example:
  113. "LASER1 c:\wp51\letters\laser1.scr"
  114.  
  115. Immediately after the application, insert a line to uninstall LASER1:
  116. "LASER1 U"
  117.  
  118. Note that the program LASER1.EXE must be in one of the directories that
  119. is in referenced in your path statement.
  120.  
  121. A Specific Example:
  122. -------------------
  123.  
  124. A demonstration screen definition file is provided, with comments.
  125. The file is "laserd.scr".
  126.  
  127. Run the bat file "demo.bat" to simulate an application that displays
  128. name and address data. When the demo customer order screen is displayed
  129. with the MORE prompt, hit the ALT D keys simultaneously, and the name
  130. and address area will be highlighted in yellow on red.
  131.  
  132. The top line of the screen will prompt you to continue. Hit enter and you
  133. will be given a preview of what the printed label will look like. Type 1, 2,
  134. or 3 to change the justification on the label. Hit enter to continue.
  135. You then select whether to print on the left or right side of the sheet.
  136. Finally, enter the position of the label you want to print. This is a number
  137. between 1 and 7, where 1 is the top label on the sheet, 4 is the middle, 7
  138. is the bottom, and so on.
  139.  
  140. Note: On different versions of DOS or BIOS, the MORE filter may put one
  141.       additional line per screen. In this case, the highlighted name and
  142.       address will be off by one line. If this happens, edit the file
  143.       LASER1.DEM and add a blank line to the top of the file.
  144.  
  145. This demo also illustrates how to add literals that are not on the screen to
  146. the label. In this case, it added "Rush To:" as the first line of the label,
  147. and also added a comma after the city.
  148.  
  149. By defining individual fields, the program allows you to change the order
  150. (the name is displayed as last, first, and mi, but prints as first, mi,
  151. and last).
  152.  
  153. Just remember to define the fields in the order you want them to print.
  154. When you want to start a new line (on the label) change the label print line.
  155.  
  156. The label print line (4th parameter) is not an absolute value, but rather
  157. it tells the program when to start a new line. In this demo, if you were to
  158. delete the "Rush To" line, it would not be necessary to renumber the label
  159. print line parameters. I will repeat an earlier statement to emphasize it:
  160.  
  161. "Just remember to define the fields in the order you want them to print.
  162. When you want to start a new line (on the label) change the label print line."
  163.  
  164. Warning:
  165. --------
  166. Since this is a memory resident program, it is important to keep the program
  167. code as small as possible. Consequently, the program does minimum syntax
  168. checking on the screen definition file. If you enter illegal rows or columns,
  169. or forget to end a line with a comma, the system will probably hang!
  170.  
  171. Limitations:
  172. ------------
  173.  
  174. This program can only capture data from TEXT based screens. It cannot
  175. read from a graphics screen such as Windows.
  176.  
  177. The maximum number of print lines on any one label is 12 (even though
  178. the label itself can only hold 8 lines)!
  179.  
  180. The program assumes your laser printer is using a font that prints at
  181. 10 characters per inch, printing at 6 lines per inch.
  182.  
  183. This shareware version of the program is set up to use two-up
  184. 1.3" by 4" labels (14 labels to a sheet), such as AVERY 5162.
  185. Registered uses will receive a more versatile program that allows
  186. them to specify label sizes and number of labels per sheet.
  187.  
  188. Warranty:
  189. ---------
  190.  
  191. There is no warranty, period.
  192. Steve Leonard specifically disclaims all warranties, expressed or implied.
  193.  
  194. Use this product at your own risk.
  195.  
  196. In no event shall Steve Leonard be liable for any loss of profit,
  197. or any other damages or loss incurred because of this product.
  198.  
  199. Steve Leonard specifically states that the effects of running the same
  200. physical sheet of labels through your printer many times over are not known,
  201. and could conceivably cause printer problems. Please check with your
  202. printer manufacturer.
  203.  
  204. Distribution of this program:
  205. ----------------------------
  206.  
  207. This program may be freely copied and distributed. Additionally, it may
  208. be distributed by Shareware companies for a fee not to exceed $10.
  209.  
  210. The only requirement is that this DOC file is included, and not altered.
  211.  
  212. If you continue to use this program after an initial 10 day evaluation
  213. period, then you are required to send a payment of $14.95 plus $2.95
  214. Shipping & Handling to :
  215.  
  216.                              Steve Leonard
  217.                              212 Green Springs Ln.
  218.                              Madison, AL 35758
  219.  
  220. Please send a couple of sample sheets of the labels you plan to use
  221. along with your payment.
  222.  
  223. Attention Corporate Customers:
  224. ------------------------------
  225.  
  226. Buy a site license for an UNLIMITED number of machines / workstations
  227. for a flat fee of $149.95.
  228.  
  229. Registration Benefit:
  230. ---------------------
  231.  
  232. Upon receipt of payment, you will be sent a more powerful version of the
  233. program that allows you to create a label definition file. This will
  234. enable you to use label sizes other than the AVERY 5162 (1.3" by 4") labels.
  235.  
  236. Additional customizations are available - please send written request
  237. for a quote.
  238.  
  239.               I may be reached on Compuserve at : 73557,203
  240.